home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / system / mail / transpor / ifmail23.z / ifmail23 / ifmail / ifgate / README < prev    next >
Encoding:
Text File  |  1994-05-08  |  6.3 KB  |  121 lines
  1. Copyright (c) 1993, 1994 by Eugene G. Crosser
  2.  
  3. This is a README file for ifgate - Internet/FidoNet gateway
  4.  
  5. You may do virtually what you wish with this software, as long as
  6. the explicit reference to its original author is retained:
  7.  
  8. Eugene G. Crosser <crosser@pccross.msk.su>, 2:5020/230@FidoNet
  9.  
  10. THIS SOFTWARE IS PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY KIND,
  11. EITHER EXPRESSED OR IMPLIED. IN NO EVENT WILL THE COPYRIGHT HOLDER BE
  12. LIABLE FOR ANY DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE.
  13.  
  14. This is a "production" version, it is more or less thoroughly tested.
  15. But that does not mean that it is error-free.  If you think that you
  16. found a bug, contact the author at crosser@pccross.msk.su.
  17.  
  18. All programs show version information and a short help message when run 
  19. with "-h" key.
  20.  
  21. This piece of software was developed to fit into my current mail/news
  22. environment: Smail 3.1 and Cnews. I honestly beleive that it also 
  23. can be easily used with sendmail, but I had no chance to try it. 
  24. With Zmailer, it works well, and so does with INN in place of Cnews.
  25.  
  26. Ifmail program converts RFC-822 compliant mail and RFC-1036 compliant 
  27. news to FTN packets. It must run setuid owner of fidonet related stuff. 
  28. The current packet naming is BinkleyTerm, with file/directory names in 
  29. lowcase. Naming conventions are implemented in a separate source file, 
  30. pktname.c, to make modifications easier.
  31.  
  32. The opposite way program is called iftoss. It expects a non-arcmail
  33. packet on stdin and passes converted mail messages and/or generated
  34. newsbatch to sendmail and/or rnews.  ATTENTION: if you specify non-zero
  35. debugging level for iftoss, resultant messages/newsbatches will go to
  36. the directory "/tmp/ifmail" instead of being fed to sendmail/rnews.
  37. Sure, you must have /tmp directory writable for ifgate programs (not
  38. only for debugging).
  39.  
  40. There are also two frontends: ifpack and ifunpack. Ifpack scans the 
  41. outbound directory and packs *.?ut packets into arcmail file attaches, 
  42. and ifunpack scans the inbound directory, unpacks and removes arcmail 
  43. files, and feeds packets to iftoss (and then removes them, or renames 
  44. if tossing was unsuccessfull). If you have a stat[v]fs() system call on 
  45. your system, ifunpack checks available space before unpacking/tossing.
  46.  
  47. For ifmail, default is mail mode operation. In mail mode, you must specify 
  48. recepient(s) address(es) in the command line, in the form: 
  49. "Eugene.Crosser@p14.f6.n5020.z2.fidonet.org". When the news mode is in 
  50. effect, i.e. "-n" key is specified or the program is called by alias 
  51. "ifnews", a news article (or batch) is expected on stdin. "-r" key is used 
  52. to specify the destination of the packet, in the form 
  53. "[pNN.]fNN.nNN[.zNN[.domain]]". In news mode, if -r key is omitted, the 
  54. first recepient address is used as routing address, and if it is absent 
  55. too, $NEWSSITE environment variable is used as a routing address.
  56.  
  57. Ifmail and iftoss programs try to preserve as much information as possible 
  58. in "X-FTN-..." headers and "^ARFC-..." kludges, and restore messages more 
  59. or less accurately to their original form when double-gatewaying.
  60.  
  61. A dbm-based alias database is supported, so if a message passes from a
  62. newsgroup to echo, the author's free form name and domain address are 
  63. stored, and when a netmail reply comes from fidonet to that free form name, 
  64. it is passed as a mail message to the remembered domain address.
  65.  
  66. Several addresses may be specified in the config file, netmail from fidonet 
  67. addressed to any of those addresses is assumed local and resolved through 
  68. the aforementioned database, otherwise the mail will be routed through the 
  69. normal MTA (and presumably packed to some other fidonet node). If there is 
  70. a "To:" line at the beginning of the fido message, address is taken from it 
  71. (ONLY THE FIRST ONE!).
  72.  
  73. On the other hand, if you make a system mail alias file accessible to the 
  74. iftoss program, it makes attempt to "backward resolve" the "from" 
  75. addresses, that is, if the originating address of the FidoNet message
  76. matches the right side of some mail alias, the "Reply-To:" header of the
  77. generated mail/news message will contain "alias@your.domain.name" address.
  78.  
  79. Message IDs are converted as follows: "^AMSGID: <address> <hexnum>" is 
  80. converted to "<decimalnum>@<address>". If there was no MSGID in the
  81. fidonet message, messageid of the form <creation-time>@<from-address> is 
  82. generated, so that when a single message is gatewayed in several distinct
  83. places, it will have the same messageid anyway (for some (little) risk of 
  84. having two different messages with the same messageid). RFC822 Message-IDs 
  85. are converted back when they can be, otherwise the messageid 
  86. "<local>@<domain>" is converted to "^AMSGID <domain> crc32(<local>)". 
  87. When an RFC message is split, unique MSGIDs are generated for all parts 
  88. after the first one. In any case, the original "Message-ID:" header is
  89. preserved in the "^ARFC-Message-ID:" kludge and used if the message comes 
  90. back to usenet on some (other) gateway.
  91.  
  92. On the way from news to echo, if the node to which the packet is being
  93. created is present in the "X-FTN-SEEN-BY:" header(s), the message is not
  94. included into the packet. SEEN-BY lines in the messages included into
  95. the packet consist of (1) your node primary address, (2) copy of
  96. "X-FTN-SEEN-BY:" header(s), (3) ftn addresses that could be parsed
  97. from the CNews file "$NEWSCTL/log" in the line with the corresponding
  98. Message-ID. For the latter to work, you should have a Cnews compatible
  99. log file available for reading and have an "ndbm" package. This works
  100. with INN too.
  101.  
  102. ATTENTION: your feed name in the cnews "sys" file should be fNNN.nMMM or
  103. pNNN.fMMM.nLLL, without zone and domain, see example.
  104.  
  105. Ifmail does some attempt to process file attaches, but only locally.
  106. No pass to Internet and back, but if a fileattach netmail message is
  107. routed from one fidonet node to another, it probably will take the
  108. attached file with it.
  109.  
  110. There is also a feature to define "forbidden" groups. If a usenet
  111. message is crossposted to some of the gated groups _and_ to some
  112. of the forbidden groups it will not be passed to any fidonet echoes.
  113. Messages with "Control:" header are not passed to FidoNet too.
  114.  
  115. Acknowledgements:
  116.  
  117. Some ideas taken from Fidogate/RFmail package, written by Teemu Torma
  118. and hacked by Martin Junius.  Some modeules taken from INN package.
  119. Thanks to Michael Bravo <mbravo@tctube.spb.su> (who was the first) and
  120. many others for testing.
  121.